home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / sticky / sticky.txt < prev    next >
Encoding:
Text File  |  1994-10-25  |  4.5 KB  |  150 lines
  1.     Documentation for Sticky -  Simple PC <> PC message sending application 
  2.  
  3. Last changed 22 May 94   
  4.  
  5. Introduction
  6. ------------
  7.  
  8. Simple VB3 WINSOCK app to allow a very simple inter-PC communication
  9. using a metaphor of those millions of bits of sticky yellow paper.
  10. You can send a message to any PC with Sticky "listen" running.
  11.  
  12.  
  13. Installation and Use
  14. --------------------
  15.  
  16. The release directory contains:
  17.  
  18.     - sticky.txt    - this documentation
  19.     - sticky.zip    - Windows 3.1 files in pkzip format
  20.  
  21.  
  22. You must have successfully installed a "winsock" TCP/IP stack before 
  23. Sticky can be run.
  24.  
  25.   1     Copy sticky.zip to your PC and unzip it into an arbitrary
  26.     directory.
  27.  
  28.   2     Some Visual Basic V3 executables/libraries must be copied to the
  29.     windows system directory:
  30.  
  31.         -  msgblast.vbx  
  32.         -  threed.vbx
  33.         -  vbrun300.dll
  34.            
  35.    
  36.    3    If you are installing sticky for the first time, the sticky.ini file 
  37.     should be copied to the windows directory.  Otherwise, dont copy 
  38.     this file, as it will overwrite your existing configuration.
  39.  
  40.  
  41.    4    The Sticky executable (sticky.exe) should be 
  42.     defined to the program manager (no working directory
  43.     is required).
  44.  
  45.     On starting for the first time, define your local friendly name
  46.     using the Configure Menu and add a few definitions for other
  47.     users of Sticky which you can send stickies to.
  48.        
  49.     
  50.     A definition consists of:
  51.         
  52.         - a friendly name, which appears later in the open 
  53.           connection list box
  54.         - the machine name (as known to DNS or whatever else your
  55.           winsock program uses to resolve names)
  56.         - the Sticky TCP/IP port number which you will
  57.           attempt to connect to on the other machine (defaults
  58.           to "6711")
  59.  
  60.     Press "ADD" to add a new definition to the list of other host
  61.     definitions.
  62.  
  63.     If you want to change an existing definition, click it and then
  64.     click "MODIFY" (or double click the definition) - the definition
  65.     will be removed from the top list and be made available for 
  66.     editing - dont forget to press "ADD" to reinsert it in the list
  67.     of other host definitions.
  68.  
  69.     To make the changes permanent, you must press the big "OK"
  70.     button on the bottom of the configuration form.
  71.  
  72.  
  73. Using it from UNIX
  74. ------------------
  75.  
  76. Try sending a message from a UNIX session by telnetting to the PC at port
  77. (default) 6711 - then type in, for example:
  78. 0005Harry0007Go home!<enter>
  79.  
  80.  
  81. Availability
  82. -------------
  83.  
  84. Written by Kent Fitch, ITSB, CSIRO Australia  kent.fitch@its.csiro.au
  85. Copyright CSIRO 1994, all rights reserved (must not be stolen or resold).
  86. Executables and doco in the public domain, source code available for 
  87. a donation to CSIRO.  Use at your own risk.  
  88.  
  89.  
  90. CSIRO is the largest publicly funded scientific research organization in the
  91. world.  It operates a large variety of research programs at sites across 
  92. Australia.
  93.  
  94. The home ftp site for Sticky is commsun.its.csiro.au, in anon ftp 
  95. directory csiro/win3/sticky
  96.  
  97.  
  98.  
  99. History
  100. -------
  101.  
  102. Versions:
  103.  
  104. 10Dec93 Beta 0.10       
  105. ??Jan94 Beta 0.21     - add BEEP on message arrival
  106. 03Apr94 Beta 0.30     - removed direct WINSOCK calls in favour of Brian
  107.             Syme's VBWSK v0.3
  108.               - combined stickyt and stickyl into one module
  109.               - add "REPLY" button
  110.               - slightly improved error messages
  111.               - improved config screen
  112. 06Apr94 Beta 0.32     - allow sorting of sticky destinations        
  113.               - allow multiple selection of sticky destinations
  114.               - fix bug which caused an incoming sticky to be
  115.             cleared from the screen by keystrokes
  116.               - fix listening bug
  117. 10Apr94 Beta 0.34     - removed extra reading socket introduced in 0.32
  118.             which sometimes causes GPF in VBWSK - the listening
  119.             socket now does the reading, ack and then reverts
  120.             to listening, rather than pass off incoming conn
  121.             to a new reading socket
  122. 15May94 Beta 0.40     - rewrite using all VB WINSOCK interface, running only
  123.             non-blocking calls.  Sticky nolonger uses VBWSK.
  124. 20mAY94 Beta 0.42     - fix overflow bug when connecting by IP num (not addr)
  125.             to hosts whose last IP num component > 128
  126. 22May94 Beta 0.44     - fix bug with multiple sender selection from list box
  127.  
  128. Acknowledgements
  129. ----------------
  130.  
  131. Steve Green, CSIRO, for thinking this would be a (good) idea.
  132.  
  133. Mark Eldridge, CSIRO, for lots of good ideas & encouragement. 
  134.  
  135. Microsoft VISUAL BASIC developers
  136.  
  137. WINSOCK specification designers 
  138.  
  139. Peter Tattam, for TRUMPET WINSOCK.
  140.  
  141. Little Feat, for Dixie Chicken.
  142.  
  143.  
  144. Bugs/Limitations
  145. ----------------
  146.  
  147.  
  148. 1.  Only 50 other Sticky hosts can be configured.
  149.  
  150.